home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BBS / DIGICHAT.ARJ / DIGICHAT.DOC < prev    next >
Text File  |  1992-09-29  |  9KB  |  241 lines
  1.                                 DigiChat 1.1
  2.                                 ~~~~~~~~~~~~
  3.                     
  4.  
  5. Turnips Cure Elvis!                    
  6.  
  7.  
  8. Overview
  9. ~~~~~~~~
  10. Tired of the annoying beeps from your PC Squeaker when a user pages you?
  11. DigiChat eliminates the "Squeak".
  12.  
  13. Digichat is a replacement for the built in Sysop Page function of many BBS
  14. programs.  It will play up to FIVE different .VOC files, and the user gets
  15. to decide which .VOC file to play.
  16.  
  17. The resulting sounds are much easier on your ears...
  18.  
  19.  
  20. Installation
  21. ~~~~~~~~~~~~
  22.  
  23. First off, obviously, you have to have a Sound Blaster or a Sound Blaster Pro
  24. (or an SB Pro II).
  25.  
  26. You must have the CT-VOICE.DRV installed also.  Although, I've been told that
  27. it works WITHOUT any SB drivers installed (Don't ask me how, I don't know).
  28.  
  29. The actual installation of DigiChat is relatively easy... (Previous users of
  30. the Digichat beta version might have to do some slight modifications)
  31.  
  32. Your "OPTIONAL DATA" line should look similar to this:
  33.  
  34. *C /C C:\RA\DIGICHAT\DCHAT.BAT
  35.  
  36. You must use a type 7 or type 15 exit from Remote Access 
  37. (Or the equivalent on another BBS program that supports DORINFOx.DEF, 
  38. EXITINFO.BBS, DOOR.SYS, CHAIN.TXT, CALLINFO.BBS or SFDOORS.DAT)
  39.  
  40.  
  41. The batch file should look something like this:
  42.  
  43. CD \RA\DIGICHAT
  44. MARK
  45. DIGICHAT x
  46. RELEASE  ^
  47.       |_____________________  This should be replaced with the node #.
  48.  
  49.  
  50.  
  51. [MARK and RELEASE are included in this package.  They are one of the most
  52.  handy utilities I've ever run across.  They will mark your current memory
  53.  location, then when Release is run, it will clear everything past the MARK.
  54.  Seeing as .VOC files can corrupt memory now and then, this is very handy 
  55.  to use.  Although, I've experienced no problems at all with the .VOC file 
  56.  corruption, it still could happen on some systems.  You are by no means 
  57.  required to use these files.  DigiChat will run just fine w/o them.]
  58.  
  59.  You must have a "DIGICHTx.CFG" file in the current directory.  The "x" should
  60.  correspond to the "x" in the batch file.  This is for multi-line systems,
  61.  so you can have more than one config file.  
  62.  
  63. Next, you should have a file called 'DIGICHAT'.[ASC/ANS/AVT] - this is 
  64. essentially a 'Menu' of commands for the user to choose from.  It should
  65. correspond to the choices in the config file.
  66.  
  67. IE:
  68.    [1] Chat File 1
  69.    [2] Chat File 2
  70.    [3] Chat File 3
  71.    [4] Chat File 4
  72.    [5] Chat File 5
  73.    [Q] Quit!  I don't want to page the sysop!
  74.    
  75. The config file:
  76.  
  77. Line 1     :  Your Name
  78. Line 2     :  Your Registration code
  79. Line 3     :  Path to your BBS drop file (DORINFO1.DEF/EXITINFO.BBS/Etc...)
  80. Line 4 - 8 :  Your Five menu choice letters/numbers that will activate the
  81.               appropriate voice file.
  82. Line 9     :  This is slightly ambiguous...  This is for the "Talking" 
  83.         routines.  This will allow a user to type in what he wants the
  84.         SB to say.  **Please see below if you wish to use 
  85.         this feature!** 
  86. Line 10    :  Your "Abort" or "Quit" command
  87. Line 11    :  String displayed when user chooses the "Abort" option
  88. *Line 12   :  File to be displayed if the user pages you outside paging 
  89.         hours.  You do NOT need the extension.
  90. Line 13-17 :  Drive, Path & Filename of your five chat files (Corresponds to
  91.               line 4 - 8)
  92. Line 18-22 :  Drive, Path & Filename to your five files that will be displayed
  93.               after the user chooses which page sound.  * You do NOT need to
  94.         include the extension - Digichat will use the appropriate
  95.         ASC/ANS/AVT extension.  (Depending on the users setting.) *
  96. *Line 23    : File to be displayed if the user pages you more times than is
  97.             permitted.  NO extension.
  98. *Line 24    : Maximum number of pages.
  99. *Line 25    : Paging hours START time - __MUST__ be in 24hr format/no colon!
  100. *Line 26    : Paging hours END time - __MUST__ be in 24hr format/no colon!
  101. Line 27     : Command to execute when using the 'External' chat function.
  102. Line 28     : ** NOT IMPLEMENTED YET, but it MUST exist ** 
  103.  
  104.  
  105. * = Registered Only Option - There MUST be something on these lines if you 
  106.                  are not registered.
  107.  
  108.  
  109.  
  110.  
  111. The config file is named DIGICHTx.CFG - "x" corresponds to the command line
  112. parameter. (IE: Digichat 1) 
  113.  
  114. Line 3 -
  115.        
  116.     This will tell Digichat where to find your BBS drop file.  
  117.     The drop files are created by your BBS to tell external programs
  118.     (Such as Digichat) who is online, how much time left, etc...  
  119.     For the [WANTS CHAT] indicator to light up when you drop back to
  120.     the BBS this must be set correctly.
  121.     If your drop file was created in your "C:\RA\LINE1" directory,
  122.     you would enter 'C:\RA\LINE1' (Without the quotes) on line 3 of 
  123.     the config file.  
  124.  
  125. Line 4 -> 8 -
  126.        
  127.     This is to allow you to customize your Digichat somewhat.  You can
  128.     enter any SINGLE CHARACTER command that you wish to have activate
  129.     the appropriate .VOC file.  
  130.     IE: Line 4 will use Line 15 as it's .VOC file.
  131.     
  132. ** Line 9 information:
  133.  
  134.     The routines for this do NOT work on my system.  I have not been able
  135.     to find the cause.  I even went out and bought another 
  136.     SoundBlaster Pro II just to see if mine was bad - it yielded the
  137.     same results.  I tried the talking programs that came with my 
  138.     SB pro (And the new ones that came with the SB pro II), everyone
  139.     except READ.EXE program bombed.  So it's not a problem with my
  140.     routines - it's with the SB itself, or another piece of hardware.
  141.     I tried taking out all non-essential cards, and still, it happened.
  142.     The only thing that it might be that is fixable is my SCSI/2 controller,
  143.     which MIGHT be causing a conflict somewhere (though, for the life of me
  144.     I can't figure out where, everything seems to be setup ok).  
  145.     You MAY be able to use this, I don't know.  I've been told it works
  146.     on some other systems, but I can't make any guarantee on this.
  147.        If you wish to use it, put a command in there, just like you would with
  148.     the other VOC files.  If you do NOT wish to use it, leave the line 
  149.     blank.  If you DO leave the line blank, make sure there is only a 
  150.     RETURN on that line, nothing else.  Not even a space (or a user 
  151.     will be able to select it with a space).  Let me know if it works
  152.     on your system, and your hardware setup.
  153.  
  154.  
  155. Line 10 -
  156.  
  157.        This command is your "Abort" or "Quit" command.  This option will
  158.     exit out of Digichat w/o playing any .VOC file - just in case the
  159.     user changes his/her mind or hits the wrong button.  This can also
  160.     be any SINGLE CHARACTER command.
  161.     
  162.  
  163. Line 11 -
  164.  
  165.        This line is displayed when the user chooses to abort.  This can 
  166.     be any string up to 200 characters.
  167.  
  168. Line 12 -
  169.        
  170.     If you are a registered
  171.  
  172. Line 13 -> 17 -
  173.  
  174.        These lines are to your .VOC files that you wish to be played when
  175.     the appropriate command (see Line 4 - 8 information) is chosen,
  176.     each line corresponds to each command above.
  177.     IE:  Line 11 will be activated by the command on line 4.
  178.     
  179. Line 18 -> 22 -
  180.  
  181.        These are the path and file names to the files (.ASC/.ANS/.AVT) that
  182.     you wish to be played after the user chooses a voice file to be
  183.     played.  My suggestion is to define these (or define them all as
  184.     the same file) so the user knows the page file is playing.  Otherwise,
  185.     if it is a long page file, they might think it has locked up and hang
  186.     up on the BBS. You do *NOT* need to include an extension, Digichat
  187.     will pick the appropriate extension, depending on the users settings.
  188.     
  189. Line 27 -
  190.  
  191.        This is for the external chat function.  This will allow you to
  192.     invoke programs such as FASTCHAT or any other external chatting
  193.     program that can be accessed from your BBS.  DigiChat has a 
  194.     built in line chatting (almost identical to RA's), but I, myself,
  195.     use Fastchat to chat with my users - this will allow you to shell
  196.     to it from DigiChat.  My suggestion is to shell to a batch file
  197.     that will switch to the appropriate directory, then call whatever
  198.     chat program you wish.    
  199.  
  200.  
  201. Notes
  202. ~~~~~
  203.  
  204. Your amount of memory free is directly proportional to the size of the .VOC
  205. file you can play.  If you are playing large .VOC files, you may want to use
  206. the *M option in RA to swap out of memory, leaving more room for the .VOC 
  207. files.  I've played a 350k .VOC file with the swap option activated.  I
  208. can't say for sure how large you can go, but theoretically, the file could
  209. be huge (Digichat will READ the .VOC off the disk in chunks IF you have
  210. enough DMA Buffers (Though, even with a 350k file you need 35+ DMA buffers).
  211. Just experiment with what you can and can't run.  But be careful, if you 
  212. overrun your memory, (And your using QEMM at least) it will complain about
  213. your DMA buffers and sit there waiting for you to either (T)erminate the
  214. program or (R)eboot the system.
  215.  
  216. See REGISTER.DOC about BETA testing Temporal Software products and free
  217. registration information.
  218.      
  219.  
  220.  
  221.  
  222.  If you have any problems, I can be contacted at:
  223.  
  224.  The Temporal Alliance
  225.  1-303-490-1047
  226.  FIDO  :  1:306/23
  227.  Youth :  13:7475/101
  228.  Anime :  27:39/10
  229.  Dual Standard HST
  230.  
  231.  or
  232.  
  233.  Temporal Software
  234.  C/O Josh Zerlan
  235.  1015M S. Taft Hill RD STE 158
  236.  Ft. Collins, CO  80521
  237.  
  238.  The latest version of DIGICHAT can always be obtained by F'Req'ing 
  239.  "DIGICHAT" from 1:306/23.
  240.  
  241.